Risk Signal: Email Verification

Email Verification enables you to assess the risk of email addresses provided by the end user. Email verification is a fundamental risk check that analyzes an email address to provide an overall risk. Email verification, adds email intelligence as a layer of defense to fraud prevention. It assesses risks by evaluating email address metadata points such as domain details, email details, and risk indicators.

Use Case

For those with onboarding and account login workflows, who wish to understand and assess the risks of a given email address.

Supported Credentials

The following values can be uploaded as Prepared Data. Alternatively, they can be extracted by an upstream capability in a workflow.

To use Prepared Data with email verification as a standalone capability use workflow key 10066.

Key	Type	Mandatory	Description
Email address	String	yes	Email Address of Applicant

Example Prepared Data Body

{
    "email": "martin***ng@gmail.com"
}

Response

Response data is available for transactions that include the risk signal. For information on transaction data see Viewing or Retrieving Workflow Transactions.

Example Response

"capabilities": {
        "emailVerification": [
            {
                "id": "e9f21fbb-4b89-4410-8f71-5040c2c303de",
                "credentials": [
                    {
                        "id": "09df1028-17bf-4a7e-a17c-c6c9c47a30e5",
                        "category": "DATA"
                    }
                ],
                "decision": {
                    "type": "PASSED",
                    "details": {
                        "label": "LOW_RISK"
                    }
                },
                "data": {
                    "emailVerificationStatus": "Verified",
                    "firstVerifiedAt": "2022-08-08T16:33:01.000Z",
                    "totalHits": "2",
                    "emailExists": true,
                    "domainExists": true,
                    "domainName": "jumio.com",
                    "domainCompany": "Jumio",
                    "domainRiskLevel": "VERY_LOW"
                    "domainCreationDate": "1995-08-13T04:00:00.000Z",
                    "advice": "LOWER_FRAUD_RISK",
                    "domainCountry": "USA",
                    "domainCategory": "Webmail",
                    "domainCorporate": false
                }
            }
        ]
    }

Decision Details Labels

Decision Type	Label	Description
PASSED	LOW_RISK
REJECTED	HIGH_RISK
WARNING	MEDIUM_RISK
NOT_EXECUTED	PERMISSION_DENIED
NOT_EXECUTED	BAD_REQUEST
NOT_EXECUTED	PRECONDITION_NOT_FULFILLED
NOT_EXECUTED	TECHNICAL_ERROR

Data

Parameter	Type	Description
firstVerificationDate	date time (UTC)	The oldest date found for records associated with the query. This date can also be considered the First Seen Date. If this is the first time an email is seen by Emailage, the field will be set to the current date. Returned in UTC format.
emailVerificationStatus	string	The status of the email generated: GeneralError: Unidentified error generated at the time of your request. Certified: The email exists and we have its creation data. Verified: The email exists but we are not sure when it was created. EmailInexistent: The email does not exist but the domain does. ValidDomain: The email domain exists, but we are not sure if the email address exists. DomainInexistent: The domain doesn't exist. Unknown: We are not sure whether the domain exists or not.
totalHits	integer	Number of times the email address was queried through the risk signal or overall vendor platform in the last 7 days.
emailExists	boolean	Indicator of whether or not the email address exists. Possible values: true / false.
domainExists	boolean	Indicator of whether or not the email domain exists. Possible values: true / false.
domainName	string	The email domain.
domainCompany	string	Owner of the email domain.
domainRiskLevel	string	Possible values: HIGH, MEDIUM, LOW.
domainCreationDate	string	The creation date of the domain. This field may be blank for some queries. Returned in UTC format: YYYY-MM-DDThh:mm:ssZ.
advice	string	Serves as a guideline based on the risk associated with the email address. Possible values are: FRAUD_REVIEW UNCLEAR_RISK LOWER_FRAUD_RISK MODERATE_FRAUD_RISK DATA_REVIEW
domainCountry	string	The country that issued the domain. Can be any ISO 3166-1 alpha-3 country code, and XKX for Kosovo. Examples: USA, AUT, GER, FRA.
domainCategory	string	Value is webmail.
domainCorporate	boolean	Indicates if the domain is corporate. Possible values: true / false.